/*
 * Copyright (c) 2018 THL A29 Limited, a Tencent company. All Rights Reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */

namespace TencentCloud.Ims.V20201229
{

   using Newtonsoft.Json;
   using System.Threading.Tasks;
   using TencentCloud.Common;
   using TencentCloud.Common.Profile;
   using TencentCloud.Ims.V20201229.Models;

   public class ImsClient : AbstractClient{

       private const string endpoint = "ims.tencentcloudapi.com";
       private const string version = "2020-12-29";

        /// <summary>
        /// Client constructor.
        /// </summary>
        /// <param name="credential">Credentials.</param>
        /// <param name="region">Region name, such as "ap-guangzhou".</param>
        public ImsClient(Credential credential, string region)
            : this(credential, region, new ClientProfile())
        {

        }

        /// <summary>
        /// Client Constructor.
        /// </summary>
        /// <param name="credential">Credentials.</param>
        /// <param name="region">Region name, such as "ap-guangzhou".</param>
        /// <param name="profile">Client profiles.</param>
        public ImsClient(Credential credential, string region, ClientProfile profile)
            : base(endpoint, version, credential, region, profile)
        {

        }

        /// <summary>
        /// 本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
        /// ### 接口使用说明：
        /// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**1万张图片**识别额度，有效期为1个月。
        /// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
        /// 
        /// ### 接口功能说明：
        /// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        /// - 支持对GIF图/长图进行截帧或拆分检测；
        /// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        /// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        /// - 支持根据不同的业务场景配置自定义的审核策略；
        /// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        /// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
        /// ### 接口调用说明：
        /// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<40000分辨率**,并且**图片长宽比<90:1；**
        /// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
        /// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
        /// - 图片文件链接支持的传输协议：HTTP、HTTPS；
        /// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
        /// - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
        /// </summary>
        /// <param name="req"><see cref="CreateImageModerationAsyncTaskRequest"/></param>
        /// <returns><see cref="CreateImageModerationAsyncTaskResponse"/></returns>
        public async Task<CreateImageModerationAsyncTaskResponse> CreateImageModerationAsyncTask(CreateImageModerationAsyncTaskRequest req)
        {
             JsonResponseModel<CreateImageModerationAsyncTaskResponse> rsp = null;
             try
             {
                 var strResp = await this.InternalRequest(req, "CreateImageModerationAsyncTask");
                 rsp = JsonConvert.DeserializeObject<JsonResponseModel<CreateImageModerationAsyncTaskResponse>>(strResp);
             }
             catch (JsonSerializationException e)
             {
                 throw new TencentCloudSDKException(e.Message);
             }
             return rsp.Response;
        }

        /// <summary>
        /// 本接口用于提交图片文件进行异步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
        /// ### 接口使用说明：
        /// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**1万张图片**识别额度，有效期为1个月。
        /// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
        /// 
        /// ### 接口功能说明：
        /// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        /// - 支持对GIF图/长图进行截帧或拆分检测；
        /// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        /// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        /// - 支持根据不同的业务场景配置自定义的审核策略；
        /// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        /// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
        /// ### 接口调用说明：
        /// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<40000分辨率**,并且**图片长宽比<90:1；**
        /// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
        /// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
        /// - 图片文件链接支持的传输协议：HTTP、HTTPS；
        /// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
        /// - 默认接口请求频率限制：**20次/秒**，超过此调用频率则会报错。
        /// </summary>
        /// <param name="req"><see cref="CreateImageModerationAsyncTaskRequest"/></param>
        /// <returns><see cref="CreateImageModerationAsyncTaskResponse"/></returns>
        public CreateImageModerationAsyncTaskResponse CreateImageModerationAsyncTaskSync(CreateImageModerationAsyncTaskRequest req)
        {
             JsonResponseModel<CreateImageModerationAsyncTaskResponse> rsp = null;
             try
             {
                 var strResp = this.InternalRequestSync(req, "CreateImageModerationAsyncTask");
                 rsp = JsonConvert.DeserializeObject<JsonResponseModel<CreateImageModerationAsyncTaskResponse>>(strResp);
             }
             catch (JsonSerializationException e)
             {
                 throw new TencentCloudSDKException(e.Message);
             }
             return rsp.Response;
        }

        /// <summary>
        /// 本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
        /// ### 接口使用说明：
        /// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**1万张图片**识别额度，有效期为1个月。
        /// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
        /// 
        /// ### 接口功能说明：
        /// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        /// - 支持对GIF图/长图进行截帧或拆分检测；
        /// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        /// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        /// - 支持根据不同的业务场景配置自定义的审核策略；
        /// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        /// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
        /// 
        /// ### 接口调用说明：
        /// - 图片文件大小支持：**文件 < 5M**
        /// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<10000分辨率**
        /// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
        /// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
        /// - 图片文件链接支持的传输协议：HTTP、HTTPS；
        /// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
        /// - 默认接口请求频率限制：**100次/秒**，超过此调用频率则会报错。
        /// -审核列表中，排序是按照用户通过API接口上传调用的时间进行排序；
        /// 
        /// <div class="rno-api-explorer" style="margin-bottom:20px">
        ///     <div class="rno-api-explorer-inner">
        ///         <div class="rno-api-explorer-hd">
        ///             <div class="rno-api-explorer-title">
        ///                 关于版本迭代的描述
        ///             </div>
        ///         </div>
        ///         <div class="rno-api-explorer-body">
        ///             <div class="rno-api-explorer-cont">
        ///                 <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
        ///                 <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
        ///             </div>
        ///         </div>
        ///     </div>
        /// </div>
        /// </summary>
        /// <param name="req"><see cref="ImageModerationRequest"/></param>
        /// <returns><see cref="ImageModerationResponse"/></returns>
        public async Task<ImageModerationResponse> ImageModeration(ImageModerationRequest req)
        {
             JsonResponseModel<ImageModerationResponse> rsp = null;
             try
             {
                 var strResp = await this.InternalRequest(req, "ImageModeration");
                 rsp = JsonConvert.DeserializeObject<JsonResponseModel<ImageModerationResponse>>(strResp);
             }
             catch (JsonSerializationException e)
             {
                 throw new TencentCloudSDKException(e.Message);
             }
             return rsp.Response;
        }

        /// <summary>
        /// 本接口（Image Moderation, IM）用于提交图片文件进行同步智能审核任务。使用前请您使用腾讯云主账号登录控制台 [开通图片内容安全服务](https://console.cloud.tencent.com/cms/image/package) 并调整好对应的业务配置。
        /// ### 接口使用说明：
        /// - 前往“[内容安全控制台-图片内容安全](https://console.cloud.tencent.com/cms/image/package)”开启使用图片内容安全服务，首次开通服务的用户可免费领用试用套餐包，包含**1万张图片**识别额度，有效期为1个月。
        /// - 该接口为收费接口，计费方式敬请参见 [腾讯云图片内容安全定价](https://cloud.tencent.com/product/ims/pricing)。
        /// 
        /// ### 接口功能说明：
        /// - 支持对图片文件或链接进行检测，通过深度学习技术，识别可能令人反感、不安全或不适宜的违规图片内容；
        /// - 支持对GIF图/长图进行截帧或拆分检测；
        /// - 支持识别多种违规场景，包括：低俗、违法违规、色情、广告等场景；
        /// - 支持多种物体检测（实体、广告台标、二维码等）及图片中文本的OCR文本识别；
        /// - 支持根据不同的业务场景配置自定义的审核策略；
        /// - 支持用户自定义选择图片风险库，打击自定义识别类型的违规图片（目前仅支持黑名单配置）；
        /// - 支持在审核图片内容时同时关联账号或设备信息，可识别违规风险账号或设备。
        /// 
        /// ### 接口调用说明：
        /// - 图片文件大小支持：**文件 < 5M**
        /// - 图片尺寸支持：**长或者宽 >50分辨率**和**长或者宽<10000分辨率**
        /// - 图片文件分辨率支持：建议**分辨率大于256x256**，否则可能会影响识别效果；
        /// - 图片文件支持格式：PNG、JPG、JPEG、BMP、GIF、WEBP格式；
        /// - 图片文件链接支持的传输协议：HTTP、HTTPS；
        /// - 若传入图片文件的访问链接，则需要注意**图片下载时间限制为3秒**，为保障被检测图片的稳定性和可靠性，建议您使用腾讯云COS存储或者CDN缓存等；
        /// - 默认接口请求频率限制：**100次/秒**，超过此调用频率则会报错。
        /// -审核列表中，排序是按照用户通过API接口上传调用的时间进行排序；
        /// 
        /// <div class="rno-api-explorer" style="margin-bottom:20px">
        ///     <div class="rno-api-explorer-inner">
        ///         <div class="rno-api-explorer-hd">
        ///             <div class="rno-api-explorer-title">
        ///                 关于版本迭代的描述
        ///             </div>
        ///         </div>
        ///         <div class="rno-api-explorer-body">
        ///             <div class="rno-api-explorer-cont">
        ///                 <p>当前页面版本为图片内容安全2020版本，2020.11.3日前接入的图片内容安全接口为2019版本，在此时间前接入的用户可直接访问以下链接进行维护操作：<a href="https://cloud.tencent.com/document/product/1125/38206" target="_blank">图片内容安全-2019版本</a></p>
        ///                 <p>2020版本相对2019版本进行了升级，支持更灵活的多场景业务策略配置以及更丰富的识别回调信息，满足不同业务的识别需求，建议按照2020版本接入指引进行接口升级；同时，2019版本也会持续维护直至用户不再使用为止。</p>
        ///             </div>
        ///         </div>
        ///     </div>
        /// </div>
        /// </summary>
        /// <param name="req"><see cref="ImageModerationRequest"/></param>
        /// <returns><see cref="ImageModerationResponse"/></returns>
        public ImageModerationResponse ImageModerationSync(ImageModerationRequest req)
        {
             JsonResponseModel<ImageModerationResponse> rsp = null;
             try
             {
                 var strResp = this.InternalRequestSync(req, "ImageModeration");
                 rsp = JsonConvert.DeserializeObject<JsonResponseModel<ImageModerationResponse>>(strResp);
             }
             catch (JsonSerializationException e)
             {
                 throw new TencentCloudSDKException(e.Message);
             }
             return rsp.Response;
        }

    }
}
